package com.xy.webadmin.app.controller;

import cn.dev33.satoken.annotation.SaCheckPermission;
import cn.hutool.core.util.ObjectUtil;
import com.xy.common.log.annotation.OperationLog;
import com.xy.common.log.model.constant.SysOperationLogType;
import com.github.pagehelper.page.PageMethod;
import com.xy.webadmin.app.vo.*;
import com.xy.webadmin.app.dto.*;
import com.xy.webadmin.app.model.*;
import com.xy.webadmin.app.service.*;
import com.xy.common.core.object.*;
import com.xy.common.core.util.*;
import com.xy.common.core.constant.*;
import com.xy.common.core.annotation.MyRequestBody;
import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.extern.slf4j.Slf4j;
import org.springdoc.core.annotations.ParameterObject;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.*;
import java.util.stream.Collectors;

/**
 * 班级操作控制器类。
 *
 * @author xiaoyue
 * @date 2025-05-13
 */
@Tag(name = "班级管理接口")
@Slf4j
@RestController
@RequestMapping("/admin/app/clazz")
public class ClazzController {

    @Autowired
    private TeacherService teacherService;
    @Autowired
    private StudentService studentService;
    @Autowired
    private ClazzService clazzService;

    /**
     * 新增班级数据。
     *
     * @param clazzDto 新增对象。
     * @return 应答结果对象，包含新增对象主键Id。
     */
    @ApiOperationSupport(ignoreParameters = {"clazzDto.id"})
    @SaCheckPermission("clazz.add")
    @OperationLog(type = SysOperationLogType.ADD)
    @PostMapping("/add")
    public ResponseResult<Long> add(@MyRequestBody ClazzDto clazzDto) {
        String errorMessage = MyCommonUtil.getModelValidationError(clazzDto, false);
        if (errorMessage != null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
        }
        Clazz clazz = MyModelUtil.copyTo(clazzDto, Clazz.class);
        // 验证关联Id的数据合法性
        CallResult callResult = clazzService.verifyRelatedData(clazz, null);
        if (!callResult.isSuccess()) {
            return ResponseResult.errorFrom(callResult);
        }
        // 验证父Id的数据合法性
        Clazz parentClazz;
        if (MyCommonUtil.isNotBlankOrNull(clazz.getParentId())) {
            parentClazz = clazzService.getById(clazz.getParentId());
            if (parentClazz == null) {
                errorMessage = "数据验证失败，关联的父节点并不存在，请刷新后重试！";
                return ResponseResult.error(ErrorCodeEnum.DATA_PARENT_ID_NOT_EXIST, errorMessage);
            }
        }
        clazz = clazzService.saveNew(clazz);
        return ResponseResult.success(clazz.getId());
    }

    /**
     * 更新班级数据。
     *
     * @param clazzDto 更新对象。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.update")
    @OperationLog(type = SysOperationLogType.UPDATE)
    @PostMapping("/update")
    public ResponseResult<Void> update(@MyRequestBody ClazzDto clazzDto) {
        String errorMessage = MyCommonUtil.getModelValidationError(clazzDto, true);
        if (errorMessage != null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
        }
        Clazz clazz = MyModelUtil.copyTo(clazzDto, Clazz.class);
        Clazz originalClazz = clazzService.getById(clazz.getId());
        if (originalClazz == null) {
            // NOTE: 修改下面方括号中的话述
            errorMessage = "数据验证失败，当前 [数据] 并不存在，请刷新后重试！";
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST, errorMessage);
        }
        // 验证关联Id的数据合法性
        CallResult callResult = clazzService.verifyRelatedData(clazz, originalClazz);
        if (!callResult.isSuccess()) {
            return ResponseResult.errorFrom(callResult);
        }
        // 验证父Id的数据合法性
        if (MyCommonUtil.isNotBlankOrNull(clazz.getParentId())
                && ObjectUtil.notEqual(clazz.getParentId(), originalClazz.getParentId())) {
            Clazz parentClazz = clazzService.getById(clazz.getParentId());
            if (parentClazz == null) {
                // NOTE: 修改下面方括号中的话述
                errorMessage = "数据验证失败，关联的 [父节点] 并不存在，请刷新后重试！";
                return ResponseResult.error(ErrorCodeEnum.DATA_PARENT_ID_NOT_EXIST, errorMessage);
            }
        }
        if (!clazzService.update(clazz, originalClazz)) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        return ResponseResult.success();
    }

    /**
     * 删除班级数据。
     *
     * @param id 删除对象主键Id。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.delete")
    @OperationLog(type = SysOperationLogType.DELETE)
    @PostMapping("/delete")
    public ResponseResult<Void> delete(@MyRequestBody Long id) {
        if (MyCommonUtil.existBlankArgument(id)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        return this.doDelete(id);
    }

    /**
     * 批量删除班级数据。
     *
     * @param idList 待删除对象的主键Id列表。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.delete")
    @OperationLog(type = SysOperationLogType.DELETE_BATCH)
    @PostMapping("/deleteBatch")
    public ResponseResult<Void> deleteBatch(@MyRequestBody List<Long> idList) {
        if (MyCommonUtil.existBlankArgument(idList)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        for (Long id : idList) {
            ResponseResult<Void> responseResult = this.doDelete(id);
            if (!responseResult.isSuccess()) {
                return responseResult;
            }
        }
        return ResponseResult.success();
    }

    /**
     * 列出符合过滤条件的班级列表。
     *
     * @param clazzDtoFilter 过滤对象。
     * @param orderParam 排序参数。
     * @param pageParam 分页参数。
     * @return 应答结果对象，包含查询结果集。
     */
    @SaCheckPermission("clazz.view")
    @PostMapping("/list")
    public ResponseResult<MyPageData<ClazzVo>> list(
            @MyRequestBody ClazzDto clazzDtoFilter,
            @MyRequestBody MyOrderParam orderParam,
            @MyRequestBody MyPageParam pageParam) {
        if (pageParam != null) {
            PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize(), pageParam.getCount());
        }
        Clazz clazzFilter = MyModelUtil.copyTo(clazzDtoFilter, Clazz.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Clazz.class);
        List<Clazz> clazzList = clazzService.getClazzListWithRelation(clazzFilter, orderBy);
        return ResponseResult.success(MyPageUtil.makeResponseData(clazzList, ClazzVo.class));
    }

    /**
     * 查看指定班级对象详情。
     *
     * @param id 指定对象主键Id。
     * @return 应答结果对象，包含对象详情。
     */
    @SaCheckPermission("clazz.view")
    @GetMapping("/view")
    public ResponseResult<ClazzVo> view(@RequestParam Long id) {
        Clazz clazz = clazzService.getByIdWithRelation(id, MyRelationParam.full());
        if (clazz == null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        ClazzVo clazzVo = MyModelUtil.copyTo(clazz, ClazzVo.class);
        return ResponseResult.success(clazzVo);
    }

    /**
     * 列出不与指定班级存在多对多关系的 [学生] 列表数据。通常用于查看添加新 [学生] 对象的候选列表。
     *
     * @param id 主表关联字段。
     * @param studentDtoFilter [学生] 过滤对象。
     * @param orderParam 排序参数。
     * @param pageParam 分页参数。
     * @return 应答结果对象，返回符合条件的数据列表。
     */
    @SaCheckPermission("clazz.update")
    @PostMapping("/listNotInStudentClazz")
    public ResponseResult<MyPageData<StudentVo>> listNotInStudentClazz(
            @MyRequestBody Long id,
            @MyRequestBody StudentDto studentDtoFilter,
            @MyRequestBody MyOrderParam orderParam,
            @MyRequestBody MyPageParam pageParam) {
        if (MyCommonUtil.isNotBlankOrNull(id) && !clazzService.existId(id)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        if (pageParam != null) {
            PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize(), pageParam.getCount());
        }
        Student filter = MyModelUtil.copyTo(studentDtoFilter, Student.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Student.class);
        List<Student> studentList =
                studentService.getNotInStudentListByClazzId(id, filter, orderBy);
        return ResponseResult.success(MyPageUtil.makeResponseData(studentList, StudentVo.class));
    }

    /**
     * 列出与指定班级存在多对多关系的 [学生] 列表数据。
     *
     * @param id 主表关联字段。
     * @param studentDtoFilter [学生] 过滤对象。
     * @param studentClazzDtoFilter 多对多关联表过滤对象。
     * @param orderParam 排序参数。
     * @param pageParam 分页参数。
     * @return 应答结果对象，返回符合条件的数据列表。
     */
    @SaCheckPermission("clazz.view")
    @PostMapping("/listStudentClazz")
    public ResponseResult<MyPageData<StudentVo>> listStudentClazz(
            @MyRequestBody(required = true) Long id,
            @MyRequestBody StudentDto studentDtoFilter,
            @MyRequestBody StudentClazzDto studentClazzDtoFilter,
            @MyRequestBody MyOrderParam orderParam,
            @MyRequestBody MyPageParam pageParam) {
        if (!clazzService.existId(id)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        if (pageParam != null) {
            PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize(), pageParam.getCount());
        }
        Student filter = MyModelUtil.copyTo(studentDtoFilter, Student.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Student.class);
        StudentClazz studentClazzFilter =
                MyModelUtil.copyTo(studentClazzDtoFilter, StudentClazz.class);
        List<Student> studentList =
                studentService.getStudentListByClazzId(id, filter, studentClazzFilter, orderBy);
        return ResponseResult.success(MyPageUtil.makeResponseData(studentList, StudentVo.class));
    }

    /**
     * 批量添加班级和 [学生] 对象的多对多关联关系数据。
     *
     * @param clazzId 主表主键Id。
     * @param studentClazzDtoList 关联对象列表。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.update")
    @OperationLog(type = SysOperationLogType.ADD_M2M)
    @PostMapping("/addStudentClazz")
    public ResponseResult<Void> addStudentClazz(
            @MyRequestBody Long clazzId,
            @MyRequestBody List<StudentClazzDto> studentClazzDtoList) {
        if (MyCommonUtil.existBlankArgument(clazzId, studentClazzDtoList)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        Set<Long> studentIdSet =
                studentClazzDtoList.stream().map(StudentClazzDto::getStudentId).collect(Collectors.toSet());
        if (!clazzService.existId(clazzId)
                || !studentService.existUniqueKeyList("id", studentIdSet)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        List<StudentClazz> studentClazzList =
                MyModelUtil.copyCollectionTo(studentClazzDtoList, StudentClazz.class);
        clazzService.addStudentClazzList(studentClazzList, clazzId);
        return ResponseResult.success();
    }

    /**
     * 更新指定班级和指定 [学生] 的多对多关联数据。
     *
     * @param studentClazzDto 对多对中间表对象。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.update")
    @OperationLog(type = SysOperationLogType.UPDATE)
    @PostMapping("/updateStudentClazz")
    public ResponseResult<Void> updateStudentClazz(
            @MyRequestBody StudentClazzDto studentClazzDto) {
        String errorMessage = MyCommonUtil.getModelValidationError(studentClazzDto);
        if (errorMessage != null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
        }
        StudentClazz studentClazz = MyModelUtil.copyTo(studentClazzDto, StudentClazz.class);
        if (!clazzService.updateStudentClazz(studentClazz)) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        return ResponseResult.success();
    }

    /**
     * 显示班级和指定 [学生] 的多对多关联详情数据。
     *
     * @param clazzId 主表主键Id。
     * @param studentId 从表主键Id。
     * @return 应答结果对象，包括中间表详情。
     */
    @SaCheckPermission("clazz.update")
    @GetMapping("/viewStudentClazz")
    public ResponseResult<StudentClazzVo> viewStudentClazz(
            @RequestParam Long clazzId, @RequestParam Long studentId) {
        StudentClazz studentClazz = clazzService.getStudentClazz(clazzId, studentId);
        if (studentClazz == null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        StudentClazzVo studentClazzVo = MyModelUtil.copyTo(studentClazz, StudentClazzVo.class);
        return ResponseResult.success(studentClazzVo);
    }

    /**
     * 移除指定班级和指定 [学生] 的多对多关联关系。
     *
     * @param clazzId 主表主键Id。
     * @param studentId 从表主键Id。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.update")
    @OperationLog(type = SysOperationLogType.DELETE_M2M)
    @PostMapping("/deleteStudentClazz")
    public ResponseResult<Void> deleteStudentClazz(
            @MyRequestBody Long clazzId, @MyRequestBody Long studentId) {
        if (MyCommonUtil.existBlankArgument(clazzId, studentId)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        if (!clazzService.removeStudentClazz(clazzId, studentId)) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        return ResponseResult.success();
    }

    /**
     * 批量移除指定班级和指定 [学生] 的多对多关联关系。
     *
     * @param clazzId 主表主键Id。
     * @param studentIdList 从表主键Id列表。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.update")
    @OperationLog(type = SysOperationLogType.DELETE_M2M_BATCH)
    @PostMapping("/deleteStudentClazzList")
    public ResponseResult<Void> deleteStudentClazzList(
            @MyRequestBody Long clazzId, @MyRequestBody List<Long> studentIdList) {
        if (MyCommonUtil.existBlankArgument(clazzId, studentIdList)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        clazzService.removeStudentClazzList(clazzId, studentIdList);
        return ResponseResult.success();
    }

    /**
     * 列出不与指定班级存在多对多关系的 [教师] 列表数据。通常用于查看添加新 [教师] 对象的候选列表。
     *
     * @param id 主表关联字段。
     * @param teacherDtoFilter [教师] 过滤对象。
     * @param orderParam 排序参数。
     * @param pageParam 分页参数。
     * @return 应答结果对象，返回符合条件的数据列表。
     */
    @SaCheckPermission("clazz.update")
    @PostMapping("/listNotInTeacherClazz")
    public ResponseResult<MyPageData<TeacherVo>> listNotInTeacherClazz(
            @MyRequestBody Long id,
            @MyRequestBody TeacherDto teacherDtoFilter,
            @MyRequestBody MyOrderParam orderParam,
            @MyRequestBody MyPageParam pageParam) {
        if (MyCommonUtil.isNotBlankOrNull(id) && !clazzService.existId(id)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        if (pageParam != null) {
            PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize(), pageParam.getCount());
        }
        Teacher filter = MyModelUtil.copyTo(teacherDtoFilter, Teacher.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Teacher.class);
        List<Teacher> teacherList =
                teacherService.getNotInTeacherListByClazzId(id, filter, orderBy);
        return ResponseResult.success(MyPageUtil.makeResponseData(teacherList, TeacherVo.class));
    }

    /**
     * 列出与指定班级存在多对多关系的 [教师] 列表数据。
     *
     * @param id 主表关联字段。
     * @param teacherDtoFilter [教师] 过滤对象。
     * @param teacherClazzDtoFilter 多对多关联表过滤对象。
     * @param orderParam 排序参数。
     * @param pageParam 分页参数。
     * @return 应答结果对象，返回符合条件的数据列表。
     */
    @SaCheckPermission("clazz.view")
    @PostMapping("/listTeacherClazz")
    public ResponseResult<MyPageData<TeacherVo>> listTeacherClazz(
            @MyRequestBody(required = true) Long id,
            @MyRequestBody TeacherDto teacherDtoFilter,
            @MyRequestBody TeacherClazzDto teacherClazzDtoFilter,
            @MyRequestBody MyOrderParam orderParam,
            @MyRequestBody MyPageParam pageParam) {
        if (!clazzService.existId(id)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        if (pageParam != null) {
            PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize(), pageParam.getCount());
        }
        Teacher filter = MyModelUtil.copyTo(teacherDtoFilter, Teacher.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Teacher.class);
        TeacherClazz teacherClazzFilter =
                MyModelUtil.copyTo(teacherClazzDtoFilter, TeacherClazz.class);
        List<Teacher> teacherList =
                teacherService.getTeacherListByClazzId(id, filter, teacherClazzFilter, orderBy);
        return ResponseResult.success(MyPageUtil.makeResponseData(teacherList, TeacherVo.class));
    }

    /**
     * 批量添加班级和 [教师] 对象的多对多关联关系数据。
     *
     * @param clazzId 主表主键Id。
     * @param teacherClazzDtoList 关联对象列表。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.update")
    @OperationLog(type = SysOperationLogType.ADD_M2M)
    @PostMapping("/addTeacherClazz")
    public ResponseResult<Void> addTeacherClazz(
            @MyRequestBody Long clazzId,
            @MyRequestBody List<TeacherClazzDto> teacherClazzDtoList) {
        if (MyCommonUtil.existBlankArgument(clazzId, teacherClazzDtoList)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        Set<Long> teacherIdSet =
                teacherClazzDtoList.stream().map(TeacherClazzDto::getTeacherId).collect(Collectors.toSet());
        if (!clazzService.existId(clazzId)
                || !teacherService.existUniqueKeyList("id", teacherIdSet)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        List<TeacherClazz> teacherClazzList =
                MyModelUtil.copyCollectionTo(teacherClazzDtoList, TeacherClazz.class);
        clazzService.addTeacherClazzList(teacherClazzList, clazzId);
        return ResponseResult.success();
    }

    /**
     * 更新指定班级和指定 [教师] 的多对多关联数据。
     *
     * @param teacherClazzDto 对多对中间表对象。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.update")
    @OperationLog(type = SysOperationLogType.UPDATE)
    @PostMapping("/updateTeacherClazz")
    public ResponseResult<Void> updateTeacherClazz(
            @MyRequestBody TeacherClazzDto teacherClazzDto) {
        String errorMessage = MyCommonUtil.getModelValidationError(teacherClazzDto);
        if (errorMessage != null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
        }
        TeacherClazz teacherClazz = MyModelUtil.copyTo(teacherClazzDto, TeacherClazz.class);
        if (!clazzService.updateTeacherClazz(teacherClazz)) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        return ResponseResult.success();
    }

    /**
     * 显示班级和指定 [教师] 的多对多关联详情数据。
     *
     * @param clazzId 主表主键Id。
     * @param teacherId 从表主键Id。
     * @return 应答结果对象，包括中间表详情。
     */
    @SaCheckPermission("clazz.update")
    @GetMapping("/viewTeacherClazz")
    public ResponseResult<TeacherClazzVo> viewTeacherClazz(
            @RequestParam Long clazzId, @RequestParam Long teacherId) {
        TeacherClazz teacherClazz = clazzService.getTeacherClazz(clazzId, teacherId);
        if (teacherClazz == null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        TeacherClazzVo teacherClazzVo = MyModelUtil.copyTo(teacherClazz, TeacherClazzVo.class);
        return ResponseResult.success(teacherClazzVo);
    }

    /**
     * 移除指定班级和指定 [教师] 的多对多关联关系。
     *
     * @param clazzId 主表主键Id。
     * @param teacherId 从表主键Id。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.update")
    @OperationLog(type = SysOperationLogType.DELETE_M2M)
    @PostMapping("/deleteTeacherClazz")
    public ResponseResult<Void> deleteTeacherClazz(
            @MyRequestBody Long clazzId, @MyRequestBody Long teacherId) {
        if (MyCommonUtil.existBlankArgument(clazzId, teacherId)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        if (!clazzService.removeTeacherClazz(clazzId, teacherId)) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        return ResponseResult.success();
    }

    /**
     * 批量移除指定班级和指定 [教师] 的多对多关联关系。
     *
     * @param clazzId 主表主键Id。
     * @param teacherIdList 从表主键Id列表。
     * @return 应答结果对象。
     */
    @SaCheckPermission("clazz.update")
    @OperationLog(type = SysOperationLogType.DELETE_M2M_BATCH)
    @PostMapping("/deleteTeacherClazzList")
    public ResponseResult<Void> deleteTeacherClazzList(
            @MyRequestBody Long clazzId, @MyRequestBody List<Long> teacherIdList) {
        if (MyCommonUtil.existBlankArgument(clazzId, teacherIdList)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        clazzService.removeTeacherClazzList(clazzId, teacherIdList);
        return ResponseResult.success();
    }

    /**
     * 以字典形式返回全部班级数据集合。字典的键值为[id, name]。
     * 白名单接口，登录用户均可访问。
     *
     * @param filter 过滤对象。
     * @return 应答结果对象，包含的数据为 List<Map<String, String>>，map中包含两条记录，key的值分别是id和name，value对应具体数据。
     */
    @GetMapping("/listDict")
    public ResponseResult<List<Map<String, Object>>> listDict(@ParameterObject ClazzDto filter) {
        List<Clazz> resultList =
                clazzService.getListByFilter(MyModelUtil.copyTo(filter, Clazz.class));
        return ResponseResult.success(MyCommonUtil.toDictDataList(
                resultList,
                Clazz::getId,
                Clazz::getName,
                Clazz::getParentId,
                Comparator.comparing(Clazz::getSort), true));
    }

    /**
     * 根据字典Id集合，获取查询后的字典数据。
     *
     * @param dictIds 字典Id集合。
     * @return 应答结果对象，包含字典形式的数据集合。
     */
    @GetMapping("/listDictByIds")
    public ResponseResult<List<Map<String, Object>>> listDictByIds(@RequestParam List<Long> dictIds) {
        List<Clazz> resultList = clazzService.getInList(new HashSet<>(dictIds));
        return ResponseResult.success(MyCommonUtil.toDictDataList(
                resultList, Clazz::getId, Clazz::getName, Clazz::getParentId));
    }

    /**
     * 根据父主键Id，以字典的形式返回其下级数据列表。
     * 白名单接口，登录用户均可访问。
     *
     * @param parentId 父主键Id。
     * @return 按照字典的形式返回下级数据列表。
     */
    @GetMapping("/listDictByParentId")
    public ResponseResult<List<Map<String, Object>>> listDictByParentId(@RequestParam(required = false) Long parentId) {
        List<Clazz> resultList = clazzService.getListByParentId("parentId", parentId);
        return ResponseResult.success(MyCommonUtil.toDictDataList(
                resultList,
                Clazz::getId,
                Clazz::getName,
                Clazz::getParentId,
                Comparator.comparing(Clazz::getSort), true));
    }

    private ResponseResult<Void> doDelete(Long id) {
        String errorMessage;
        // 验证关联Id的数据合法性
        Clazz originalClazz = clazzService.getById(id);
        if (originalClazz == null) {
            // NOTE: 修改下面方括号中的话述
            errorMessage = "数据验证失败，当前 [对象] 并不存在，请刷新后重试！";
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST, errorMessage);
        }
        if (clazzService.hasChildren(id)) {
            // NOTE: 修改下面方括号中的话述
            errorMessage = "数据验证失败，当前 [对象存在子对象] ，请刷新后重试！";
            return ResponseResult.error(ErrorCodeEnum.HAS_CHILDREN_DATA, errorMessage);
        }
        if (!clazzService.remove(id)) {
            errorMessage = "数据操作失败，删除的对象不存在，请刷新后重试！";
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST, errorMessage);
        }
        return ResponseResult.success();
    }
}
